uucp
Section: User Commands (1)
Updated: Taylor UUCP 1.04
Index
Return to Main Contents
NAME
uucp - Unix to Unix copy
SYNOPSIS
uucp
[ options ] source-file destination-file
uucp
[ options ] source-file... destination-directory
DESCRIPTION
The
uucp
command copies files between systems. Each
file
argument is either a pathname on the local machine or is of the form
-
system!path
which is interpreted as being on a remote system.
In the first form, the contents of the first file are copied to the
second. In the second form, each source file is copied into the
destination directory.
A file be transferred to or from
system2
via
system1
by using
-
system1!system2!path.
Any pathname that does not begin with / or ~ will be appended to the
current directory (unless the
-W
option is used); this resulting path will not necessarily exist on a
remote system. A pathname beginning with a simple ~ starts at the
UUCP public directory; a pathname beginning with ~name starts at the
home directory of the named user. The ~ is interpreted on the
appropriate system. Note that some shells will interpret a simple ~
to the local home directory before
uucp
sees it; to avoid this the ~ must be quoted.
Shell metacharacters ? * [ ] are interpreted on the appropriate
system, assuming they are quoted to prevent the shell from
interpreting them first.
The copy does not take place immediately, but is queued up for the
uucico
(8) daemon; the daemon is started immediately unless the
-r
switch is given. In any case, the next time the remote system is called the
file(s) will be copied.
OPTIONS
The following options may be given to
uucp.
- -c
-
Do not copy local source files to the spool directory. If they are
removed before being processed by the
uucico
(8) daemon, the copy will fail. The files must be readable by the
uucico
(8) daemon, and by the invoking user.
- -C
-
Copy local source files to the spool directory. This is the default.
- -d
-
Create all necessary directories when doing the copy. This is the
default.
- -f
-
If any necessary directories do not exist for the destination path,
abort the copy.
- -g grade
-
Set the grade of the file transfer command. Jobs of a higher grade
are executed first. Grades run 0 ... 9 A ... Z a ... z from high to
low.
- -m
-
Report completion or failure of the file transfer by
mail
(1).
- -n user
-
Report completion or failure of the file transfer by
mail
(1) to the named
user on the remote system.
- -r
-
Do not start
uucico
(8) daemon immediately; merely queue up the file transfer for later
execution.
- -j
-
Print jobid on standard output. The job may be
later cancelled by passing the jobid to the
-k
switch of
uustat
(1).
It is possible for some complex operations to produce more than one
jobid, in which case each will be printed on a separate line. For
example
uucp sys1!~user1/file1 sys2!~user2/file2 /usr/spool/uucppublic
will generate two separate jobs, one for the system
sys1
and one for the system
sys2.
- -W
-
Do not prepend remote relative path names with the current directory.
- -x type
-
Turn on particular debugging types. The following types are
recognized: abnormal, chat, handshake, uucp-proto, proto, port,
config, spooldir, execute, incoming, outgoing. Only abnormal, config,
spooldir and execute are meaningful for
uucp.
Multiple types may be given, separated by commas, and the
-x
option may appear multiple times. A number may also be given, which
will turn on that many types from the foregoing list; for example,
-x 2
is equivalent to
-x abnormal,chat.
- -I file
-
Set configuration file to use. This option may not be available,
depending upon how
uucp
was compiled.
FILES
The file names may be changed at compilation time or by the
configuration file, so these are only approximations.
/usr/lib/uucp/config - Configuration file.
/usr/spool/uucp -
UUCP spool directory.
/usr/spool/uucp/Log -
UUCP log file.
/usr/spool/uucppublic -
Default UUCP public directory.
SEE ALSO
mail(1), uux(1), uustat(1), uucico(8)
BUGS
Some of the options are dependent on the capabilities of the
uucico
(8) daemon on the remote system.
The
-n
and
-m
switches do not work when transferring a file from one remote system
to another.
File modes are not preserved, except for the execute bit. The
resulting file is owned by the uucp user.
AUTHOR
Ian Lance Taylor
(ian@airs.com or uunet!airs!ian)
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- OPTIONS
-
- FILES
-
- SEE ALSO
-
- BUGS
-
- AUTHOR
-
This document was created by
man2html,
using the manual pages.
Time: 00:35:06 GMT, March 30, 2022